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5.0 Reference 

This section describes the actual OLE Interfaces exposed, the definitions of the data structures 
used when passing data around, and the definitions of each class used internally by the XMC 
Motion Control Component. 



5.1 Interfaces 

Other than the standard OLE interfaces IUnkJiown, IClassFactory, and IDispatch, and the 
custom XMCAPI OLE interfaces, there are no special interfaces exposed by the XMC Motion 
Control Component. The diagram below displays a graphicaj representation of the interfaces 
exposed by the XMC Motion Control Component. 
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Figure 8 Interface-Map. 

For more information on the standard OLE interfaces see the OLE 2 Programmer's Reference. 
And, for more information on the custom XMCAPI interfaces, see toe XMCAPI Reference. 

5.2 Exported Functions 

The following are the functions exported by the driver DLL. 



XMC COMPONENTJ40DULETYPE 

LPCLSID 

BOOL 

BOOL 



DLLGetModuleType ( void ) ; 
DLLGetCLSID ( void ); 
DLLRegisterServer ( void ); 
DLLUnRegisterServer ( void ); 



5.3 Structures and Defines 

This section defines all structures, enumerations, and defines used by the driver. 

5.3.1 XMC_COMPONENT_MODULETYPE Enumeration 

The following enumeration is used to mark the module type of the component. 



enuxn XMC_COMPONENT_MODULETYPE 



XMC COMPONENT MT 



0x7000 



I; 
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5.3.2 XMC_API Enumeration 

The following enumeration is used to index all XMCAP1 supported by the component. 

enum XMC_API 
{ 

XMC_API_MOTION_MOVEABS , 
XMC_API_MOTION_MOVEREL, 
XMC_API_MOTION_KILL, 

); 

533 XMCJVIAPMODE Enumeration 

The following enumeration is used to specify the type of mapping to use when converting between 
the MCS and PCS. 

enum XMC.MAPMODE 
{ 

xmc_mm_metric, 

xmc_mm_english, 

xmc~mm~native 

5.4 Classes 

This section contains the definition of all classes used by the XMC Motion Control Component in 
its implementation. 

' 5.4.1 CCmpntDisp Class 
The CCmpntDisp class acts as the dispatch, or control, object used to separate all OLE details 
from the code implementing the driver internals. This object coordinates all operations taking 
place in the driver by directing other C++ object to cany out the work of the operation. The 
following is the definition of the CCmpntDisp class. 

class CCmpntDisp 
( 

public: 

// Constructors & Destructors 

CCmpntDisp ( void ) ; 
-CCmpntDisp ( void ); 

// Initialization 

DWORD Initialize { void ); 

//-• Actions 

DWORD FireAPK XMC_API apilDX, ... ); 

private: 

■ // Private Methods 

DWORD verifyParams ( ... ) ; 
DWORD verif yState ( ... ); 

// Private API Methods 
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// Private Data 

CDriverMgr m_drvMgr; 

) ; 

5.4.2 CDriverAdmin Class 

The CDriverAdmin class is used to directly communicate with the driver administrator 
component. All OLE related details are encapsulated within this class. The following is 
definition of the CDriverAdmin class. 

class CDriverAdmin 
{ 

public: 

// Constructors & Destructors 

CDriverAdmin ( void ); 
-CDriverAdmin ( void ); 

// Initialization 

DWORD Initialize ( void ); 



// Actions 

DWORD EnumDriverf LPENUMDRIVER ♦ppEnumDriver ); 

DWORD RegisterDriver { LPCTSTR pszFileName, 

BOOL bEnabled, 
LPXMC_H DRIVER phDrv ) ; 

DWORD RegisterStream{ LPCTSTR ps"zFileName, 

BOOL bEnabled, 
XMC_HDRIVER hDrv, 
LPXMC_HSTREAM phStrm ) ; 

DWORD UnRegister( XMC_HDRIVER hDrv, XMC_H STREAM hStrm ); 

DWORD GetSupportlnf o ( LPXMCDRIVERINTERFACES UP PORT INFO rgDIFS ) 
// Debugging 

DWORD EnableDiagnostics ( BOOL bEnable ) ; 



private : 

// Private Data 

LPXMCDRIVERADMIN . m_lpDA; 

LPXMCDRIVERADMINDEBUG m_lpDADbg ; 



); 
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5.4.3 CDriverMgr Class 

The CDriverMgr class manages all active drivers used in the XMC system. Currently, XMC only 
supports single driver operation. When the software model is expanded to support multiple driver, 
the CDriverMgr will be responsible for managing all drivers by virtualizing them to form one 
contiguous set of axes. The CDriverMgr also controls the process of unit'mapping. Below, is the 
definition of the CDriverMgr class. 

class CDriverMgr 
( 

public: 

// Constructors & Destructors 

CDriverMgr ( void ); 
-CDriverMgr ( void ) ; 

// Initialization 

DWORD Initialize ( void )•; 

// Setup Operations 

DWORD RegisterDrivers ( LPENUMDRIVER 'ppEnumDriver, 

LPENUMINTERFACESUPPORT *ppIFS ) ; 
DWORD SetMappingMode ( XMCJ1APMODE mapMode ) ; 
DWORD SetBaseUnits { double dfMCPerMM, double dfECPerMM ) ; 

// Actions 

DWORD FireAPK XMC_API apiCMD, ... ); 



private : 



// Private Methods — 

DWORD mapPCStoMCS ( ... ) ; 
DWORD mapMCStoPCS ( ... ) : 



// Private Data 

CUnitMapper 

CDriver 

DWORD 



m_unitMapper ; 
*m_rgDrivers; 
m cbDrivers; 



5.4.4 CUnitMapper Class 

The CUnitMapper class is used to map all measurements between MCS and PCS. The 
CUnitMapper class is defined as follows. 



class CUnitMapper 



public : 



//- 



Constructors & Destructors — 



CUnitMapper ( void ); 
^CUnitMapper { void ); 



// Initialization 
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DWORD SetMappingModef XMC_MAPMODE mapMode ) 
DWORD SetBaseMCUnit ( double dfMCPerMM ); 
DWORD SetBaseECUnit ( double dfECPerMM ); 



// Actions 

double MapMCStoPCS( double dfVal ); 
double MapPCStoMCSt double dfVal ); 



private: 

// private Data 



double 
double 
double 
double 



m_dfMCStoPCS; 
m_dfPCStoMCS; 
m_dfMCPerMM; 
m dfECPerMM; 



); 



5.4.5 CDriver Class 

The CDriver implements the internal XMCSPI table that stores pointers to exposed methods in 
both the XMC Driver and XMC Driver Stub. A function pointer pointing to each extended 
XMCSPI function, not supported by the XMC Driver that may be simulated through a software 
algorithm, is stored in the XMCSPI table. All other entries, in the table, consist of function 
pointers to XMCSPI functions implemented by the XMC Driver. Graphically, the internal data 
map for the CDriver class is as follows. ^ 
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struct DKvrxr_xNTrRF*cr_iHro 

{ enum DKVKXTJCn_MtTHODIDS 



DRVEXT JCn_K£THODl 
DRVEXTJCn~METH0D2 
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Struct DKVEXT_METHOD_INFO 
I 

XMC SUPPORTTYPE m_st; 
CStrinq m_3trName; 
LP FN DRVEXT m_pfnMethod; 



I- 



Figure 9 Data-Map - CDriver class with XMCSPI table. 

The purpose of the CDriver class is to manage ail connections to both the driver and driver stub. 
All OLE specific details are encapsulated within the CDriver class. The following is the definition 
of the CDriver class. 



class CDriver 
( 



public 



// Constructors & Destructors — 



CDriver ( void ) ; 
-CDriver ( void ), 
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// Initialization 

DWORD Initialize ( void ); e ... . . 

DWORD Initialize ( LPUNKNOWN pDrvUnk, LPUN KNOWN pDrvStbUnk ), 

// Actions 

DWORD Attach( LPUNKNOWN pDrvUnk, LPUNKNOWN pDrvStbUnk ) ; 
DWORD Detach ( LPUNKNOWN 'ppDrvUnk, LPUNKNOWN 'ppDrvStbUnk ); 
DWORD FireCoreSPK XMC CORESPI corespilDX, ... ); 
DWORD FireExtSPK XMC_EXTSPI extspilDX, ... ); 

private: 

// Private Data 

DRVCORE SPIMAP_INFO mjrgCoreSPIMap [] ; 

DRVEXT_SPIMAP_INFO m_rgExtSPIMap ( ] ; 

LPUNKNOWN m_pDrvUnk; 

LPUNKNOWN ' m_pDrvStbUnk; 

); 

NOTE: For more information on the XMCJCORESPi and XMC^EXTSPI types see the XMC 
Motion Control - Driver Design Guide. 
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